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PREFACE 


This  product  specification  covers  the  work  performed  under 
Air  Force  Contract  F33615-80-C-5155  (ICAM  Project  6201).  This 
contract  is  sponsored  by  the  Materials  Laboratory,  Air  Force 
Systems  Coaaand,  Wright-Patterson  Air  Force  Base,  Ohio.  It  was 
administered  under  the  technical  direction  of  Mr.  Gerald  C. 
Shumaker,  ICAM  Program  Manager ,  Manufacturing  Technology 
Division,  through  Project  Manager.  Mr.  David  Judson.  The  Prime 
Contractor  was  Production  Resources  Consulting  of  the  General 
Electric  Company,  Schenectady,  New  York,  under  the  direction  of 
Mr.  Alan  Rubenstein.  The  General  Electric  Project  Manager  was 
Mr.  Myron  Hurlbut  of  Industrial  Automation  Systems  Department, 
Albany,  Mew  York. 

Certain  work  aimed  at  improving  Test  Bed  Technology  has 
been  performed  by  other  contracts  with  Project  6201  performing 
integrating  functions.  This  work  consisted  of  enhancements  to 
Test  Bed  software  and  establishment  and  operation  of  Test  Bed 
hardware  and  communications  for  developers  and  other  users. 
Documentation  relating  to  the  Test  Bed  from  all  of  these 
contractors  and  projects  have  been  integrated  under  Project  6201 
for  publication  and  treatment  as  an  integrated  6et  of  documents. 
The  particular  contributors  to  each  document  are  noted  on  the 
Report  Documentation  Page  (DD1473).  A  listing  and  description 
of  the  entire  project  documentation  system  and  how  they  are 
related  is  contained  in  document  FTR6201 00001 ,  Project  Overview. 

The  subcontractors  and  their  contributing  activities  were 
as  follows: 


TASK  4,2 

Subcontractors 

Boeing  Military  Aircraft 
Company  (BMAC) 

D.  Appleton  Company 
(DAC0M) 


General  Dynamics/ 
Ft.  Worth 


Role 

Reviewer 


Responsible  for  IDEF  support, 
state-of-the-art  literature 
search 

Responsible  for  factory  view 
function  and  information 
models 


iii 
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Subcontractors 

Illinois  Institute  of 
Technology 

North  American  Rockwell 
Northrop  Corporation 

Pritsker  and  Associates 
S of Tech 


Role 


Responsible  for  factory  view 
function  research  (IITRI) 
and  information  models  of 
small  and  medium-size  business 

Reviewer 

Responsible  for  factory  view 
funotion  and  information 
models 

Responsible  for  IDEP2  support 
Responsible  for  IDEFO  support 


TASKS  4.3  -  4.9  (TEST  BED) 
Subcontractors  Role 


Boeing  Military  Aircraft 
Company  (BMAC) 


Responsible  for  consultation  on 
applications  of  the  technology 
and  on  IBM  computer  technology. 


Computer  Technology 
Associates  (CTA) 


Assisted  in  the  areas  of 
communications  systems,  system 
design  and  integration 
methodology,  and  design  of  the 
Network  Transaction  Manager. 


Control  Data  Corporation 
(CDC) 


Responsible  for  the  Common  Data 
Model  (CDM)  implementation  and 
part  of  the  CDM  design  (shared 
with  DAOOM). 


D.  Appleton  Company 
(DAOOM) 


Responsible  for  the  overall  CDM 
Subsystem  design  integration 
and  test  plan,  as  well  as  part 
of  the  design  of  the  CDM 
(shared  with  CDC).  DAOOM  also 
developed  the  Integration 
Methodology  and  did  the  schema 
mappings  for  the  Application 
Subsystems . 


iv 
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Subcontractors 


Role 


Digital  Equipment 
Corporation  (DEC) 


McDonnell  Douglas 
Automation  Company 
(McAuto) 


On-Line  Software 
International  (OSI) 


Consulting  and  support  of  the 
performance  testing  and  on  DEC 
software  and  computer  systems 
operation. 

Responsible  for  the  support  and 
enhancements  to  the  Network 
Transaction  Manager  Subsystem 
during  1984/1985  period. 

Responsible  for  programming  the 
Communications  Subsystem  on  the 
IBM  and  for  consulting  on  the 
IBM. 


Rath  and  Strong  Systems 
Produots  (RSSP)  (In  1985 
became  MoCormack  9  Dodge) 


SofTeoh ,  Inc . 


Software  Performance 
Engineering  (SPE) 


Structural  Dynamics 
Research  Corporation 
(SDRC) 


Responsible  for  assistance  in 
the  Implementation  and  use  of 
the  MRP  II  package  (PIOS)  that 
they  supplied. 

Responsible  for  the  design  and 
implementation  of  the  Network 
Transaction  Manager  (HTM)  in 
1981/1984  period. 

Responsible  for  directing  the 
work  on  performance  evaluation 
and  analysis. 

Responsible  for  the  User 
Interface  and  Virtual  Terminal 
Interface  Subsystems . 


Other  prime  contractors  under  other  projects  who  have 
contributed  to  Test  Bed  Technology,  their  contributing 
activities  and  responsible  projects  are  as  follows: 


Contractors 


ICAM  Project  Contributing  Activities 


Boeing  Military 
Aircraft  Company 
(BMAC) 


1701 ,  2201 ,  Enhancements  for  IBM 
2202  node  use.  Technology 

Transfer  to  Integrated 
Sheet  Metal  Center 
(ISMC) 
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Contractors 

I CAM  Project 

Contributing  Activities 

Control  Data 
Corporation  (CDC) 

1502,  1701 

IISS  enhancements  to 
Common  Data  Model 
Processor  (CMP) 

D.  Appleton  Company 
( DACOM ) 

1502 

IZSS  enhancements  to 
Integration  Methodology 

General  Electric 

1502 

Operation  of  the  Test 
Bed  and  communications 
equipment . 

Hughes  Aircraft 

Company  (HAC) 

1701 

Test  Bed  enhancements 

Structural  Dynamics 
Research  Corporation 
(SDRC) 

1502,  1701. 
1703 

IISS  enhancements  to 
User  Interface/ Virtual 
Terminal  Interface 
(UI/VTI ) 

Systran 

1502 

Test  Bed  enhancements. 
Operation  of  Test  Bed. 
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SECTION  1 


SCOPE 


1 . 1  Identification 

^  ^This  specification  establishes  the  design  of  Function  PRE3, 
?-"Parse  NDHL*^  one  of  the  major  functions  of  the  Configuration 
Item  ‘‘Precompiler"  to  be  built  and  formally  accepted  by  the  ICAM 
Program  Office.  This  CPCI  constitutes  one  of  the  subsystems  of 
the  Common  Data  Model  Processor  (CDMP).  A 


Cl 


Functional  Summary 

r  — -  ^ 

This  function?parses  the  NDML  statements  into  tokenized 


1.2 

A  A 

form.  Legal  syntax  is  checked  and  syntax  error  messages  issued. 
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SECTION  2 
DOCUMENTS 


2. 1  Reference  Documents 

1.  ICAM  Documentation  Standards:  IDS15012000A,  28 
December  1981. 

2.  D.  Appleton  Co..  CDM  Administrators  Manual: 

UM620141000 .  March  1984. 

3.  D.  Appleton  Co..  CDM1-IDEF1  Model  of  the  Common  Data 
Model:  CCS620 141000 ,  15  May  1985. 

4.  D.  Appleton  Co..  Computer  Program  Development 
Specification  (DS)  for  ICAM  Integrated  Support  System 
(IISS)  Configuration  Item:  NDML  Precompiler; 
DS620141200.  October  1984. 

5.  D.  Appleton  Co..  Embedded  NDML  Programmer's  Reference 
Manual;  PRM620141200 ,  March  1985. 

6.  Softech.  Inc..  NTM  Programmer's  Guide:  UM620140001 , 
July  1984. 

7.  Control  Data  Corporation.  Computer  Program  Development 
Specification  (DS)  for  ICAM  Integrated  Support  System 
(IISS)  Configuration  Item:  NDDL  Command  Processor; 
DS620141 100 .  June  1985. 


2.2  Terms  and  Abbreviations 

Attribute  Use  Class :  ( AUC ) 

Conceptual  Schema:  (CS) 

Common  Data  Model  Processor:  (CDMP) 

Common  Data  Model:  (CDM)  Describes  common  data  application 
process  formats,  form  definitions,  etc,  of  the  IISS  and  includes 
conceptual  schema,  external,  internal  schemas,  and  schema 
transformation  operators. 

Data  Field:  (DF)  An  element  of  data  in  the  external 
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schema.  It  is  by  this  name  that  am  NDHL  programmer  references 
data. 

Database  Management  System :  ( DBMS ) 

Distributed  Request  Supervisor:  (DRS)  This  IISS  CDM 
subsystem  configuration  item  controls  the  execution  of 
distributed  MDML  queries  and  non  distributed  updates. 

Domain:  A  logical  definition  of  legal  attribute  class 
values. 

Domain  Constraint:  Predicate  that  applies  to  a  single 
domain. 

External  Schema :  ( ES ) 

Forms :  Structured  views  which  may  be  imposed  on  windows  or 
other  forms.  A  form  is  composed  of  fields  where  each  field  is  a 
form,  item,  or  window. 

Forms  Processor:  (FP)  A  set  of  callable  execution  time 
routines  available  to  an  application  program  for  form 
processing. 

Internal  Schema:  (IS) 

Integrated  Information  Support  System:  (IISS)  A  test 
computing  environment  used  to  investigate,  demonstrate  and  test 
the  concepts  of  information  management  and  information 
integration  in  the  context  of  Aerospace  Manufacturing.  The  IISS 
addresses  the  problems  of  integration  of  data  resident  on 
heterogeneous  databases  supported  by  heterogeneous  computers 
interconnected  via  a  local  Area  Network. 

Mapping:  The  correspondence  of  independent  objects  in  two 
schemas:  ES  to  CS  or  CS  to  IS. 

Network  Transaction  Manager:  (NTM)  Performs  the 
coordination,  communication  and  housekeeping  functions  required 
to  integrate  the  application  processes  and  system  services 
resident  on  the  various  hosts  into  a  cohesive  system. 

Neutral  Data  Manipulation  Language:  (NDML)  A  language 
developed  by  the  IISS  project  to  provide  uniform  access  to 
common  data,  regardless  of  database  manager  or  distribution 
criteria.  It  provides  distributed  retrieved  and  single  node 
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updates . 

ORACLE :  Relational  DBMS  based  on  the  SQL  (Structured  Query 
Language ,  a  product  of  ORACLE  Corp,  Menlo  Park.  CA).  The  CDM  is 
an  ORACLE  database . 

Parcel:  A  sequential  file  containing  sections  source  code 
of  the  input  application  program. 

Request  Processor:  (RP)  A  COBOL  program  that  will  satisfy 
a  retrieval  or  update  NDML  subtransaction  against  a  particular 
Database  Management  System. 

User  Interface:  (UI)  Controls  the  user's  terminal  and 
interfaces  with  the  rest  of  the  system. 

Virtual  Terminal  Interface:  (VTI)  Performs  the  interfacing 
between  different  terminals  and  the  UI .  This  is  done  by 
defining  a  specific  set  of  terminal  features  and  protocols  which 
must  be  supported  by  UI  software  which  constitutes  the  Virtual 
Terminal  Definition.  Specific  terminals  are  then  mapped  against 
the  Virtual  Terminal  software  by  specific  software  modules 
written  for  each  type  of  real  terminal  supported. 


PS  620141213 
1  November  1985 


SECTION  3 
REQUIREMENTS 

3. 1  Structural  Description 

A  graphic  portrayal  of  this  Computer  Program  Configuration 
Item  CCPCI)  is  included  in  Section  3.10.  This  chart  shows  the 
hierarchical  relationship  of  each  nodule  making  up  this  CPCI. 
This  nodule  is  accessed  for  each  NDML  command  identified  by 
PRE2.  The  routine  is  generated  by  the  UNIX  tools  YACC  and  LEX. 
YACC  generates  a  parser  given  the  syntax  rules  as  input.  LEX 
generates  the  lexical  analyzer  for  the  language  given  the 
definitions  of  the  lexical  units  of  the  language.  The  parser 
generated  by  YACC  is  named  YYPARSE  and  the  lexical  analyzer  is 
named  YYLEX.  PRE2  controls  the  call  to  YYPARSE.  Whenever 
YYPARSE  (the  parser)  needs  another  token  or  unit  of  command 
input,  YYLEX  is  called.  Whenever  YYLEX  needs  another  character 
of  the  user  command,  YYINPUT  is  called.  In  this  application, 

YY INPUT  has  been  modified  to  record  the  next  character  from  the 
file  containing  NDML  commands.  The  parsed  tokens  are  stored  in 
global  data  structures  accessible  by  "C"  primitives.  PRE2  then 
uses  these  primitives  to  access  the  "C"  data  structures,  storing 
them  in  COBOL  tables  and  checking  command  semantics. 

3.2  Functional  Flow 

This  CPCI  implements  the  logic  defined  in  the  Development 
Specification  for  this  CPCI.  Details  of  inputs /outputs  and 
relationships  between  modules  are  to  be  found  in  Section  3.10. 

This  CPCI  has  been  designated  to  operate  in  a  batch  or 
interactive  mode.  It  must  operate  in  the  system  environment 
established  for  IISS;  that  is,  use  of  the  Network  Transaction 
Manager.  It  must  use  the  ORACLE  DBMS  installed  on  a  DEC  VAX 
computer . 
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3.3  Interfaces 


The  following  diagram  depicts  the  interface  of  PRE3  with 
other  CPCI's  in  the  system. 


+ - + 

I  PRE2  I 
I PS41212  I 
+ - + - + 


+ - + - + 

I  PRE3  I 

I  I 

+ - + 

3.3.1  Input s /Outputs 

The  following  table  depicts  the  inputs  and  outputs  of  this 
CPCI.  A  detailed  description  for  each  item  can  be  found  in  the 
DS  for  this  CPCI. 

FUNCTION :  PRE3 

INPUT  OUTPUT 


Command  Number 


Module  Status 

3.4  Program  Interrupts 

Not  applicable  to  this  CPCI. 

3 . 5  Timing  and  Sequencing  Description 

PRES  is  called  once  for  every  NDML  statement  encountered  in 
the  user's  input  program. 
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3.6  Special  Control  Features 
Mot  applicable  to  this  CPCI . 

3.7  Storage  Allocation 

3.7.1  Database  Definition 

Mo  databases  are  used  by  this  CPCI. 

3. 7. 1.1  File  Description 

Mo  permanent  files  have  been  defined  for  this  CPCI.  It  aay 
use  temporary  scratch  files  for  such  things  as  generated  program 
source  code  or  temporary  query  results. 

3. 7. 1.2  Table  Description 

All  tables  used  by  this  CPCI  have  been  defined  by  the 
Development  Specification  for  this  CPCI. 

3. 7. 1.3  Item  Description 

Mot  applicable  to  this  CPCI. 

3.8  Object  Code  Creation 

The  object  code  for  this  CPCI  will  be  created  by  the  system 
integration  test  team  by  using  defined  IISS  Software 
Configuration  Management  procedures.  This  CPCI  will  use  the 
COBOL  and  "C"  language  compilers.  In  addition,  source  code 
generated  by  the  YACC  and  LEX  tools  must  be  compiled  to  become 
objects  in  the  final,  executable  software  package . 

3.9  Adaptation  Data 

This  CPCI  has  been  coded  using  ANSI  COBOL  and  a  "standard” 
subset  of  the  “C"  languages.  The  intent  was  to  provide  a 
transportable  system.  Any  system  environment  supporting  these 
languages,  a  virtual  memory  management  scheme,  the  COMM  and  NTH 
subsystems  of  IISS  and  the  ORACLE  Database  Management  System 
should  be  able  to  support  this  CPCI.  Every  possible  attempt  has 
been  made  to  localize  and  identify  any  machine  or  environment 
dependent  modules  through  the  original  design  of  the  IISS  and 
application  of  Configuration  Management  Procedures. 

3.10  Detail  Design  Description 
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The  following  sections  have  been  computer  generated  for 
this  CPCI. 


3.10.1  Main  Program  List 

The  following  is  a  list  of  all  "Main  Programs"  which 
are  modules  that  are  not  called  by  any  other  module  being 
documented  here.  These  modules  are  either  program  entry  points 
or,  if  they  are  hooked  into  smother  set  of  programs  via 
subroutine  calls,  they  are  the  points  the  external  programs  can 
call  and  therefore  enter  through.  To  differentiate  between  the 
two  types  of  entry  points,  look  at  the  individual  Module 
Documentation  (section  3.10.8)  and  look  at  Module  Type  for  each 
of  the  Main  Program  modules  listed.  Note  whether  the  routine 
is  a  Program,  Subroutine,  or  Function.  If  it  is  a  Program,  it 
is  truly  a  main  program  entry  point.  If  not.  then  it  is  merely 
called  by  other  programs  not  being  documented  here. 


PS  620141213 
1  November  1985 


PARSE  NDML  COMMAND  Main  Program  List 


Module  Name 


Purpose 


NDMLPAR 


****  PURPOSE  NOT  FOUND  BY  STRIPPER 


YYPARSE 


PURPOSE  NOT  FOUND  BY  STRIPPER 


YYWRAP 


****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 
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3.10.2  Module  List 

The  following  is  a  list  of  all  the  modules  being 
documented  here  along  with  their  purpose.  Each  module  has  a 
unique  name,  no  matter  what  language  it  was  written  in. 
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a 

Lit. 
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PARSE  MDML  COMMAND  Module  List 


Module  Name 

Purpose 

NDMLPAR 

•  •  *  * 

PURPOSE 

MOT 

FOUND 

BY 

STRIPPER 

*  •  *  • 

TTERROR 

MM 

PURPOSE 

MOT 

FOUND 

BY 

STRIPPER 

«  *  *  * 

YTPARSE 

*  •  •  • 

PURPOSE 

MOT 

FOUND 

BY 

STRIPPER 

•  •  •  t 

YYVRAP 

*  #  *  * 

PURPOSE 

MOT 

FOUND 

BY 

STRIPPER 

»  •  •  • 
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3.10.3  External  Routines  List 

The  following  is  a  list  of  all  routines  or  functions  not 
documented  here  that  are  called  by  modules  that  are  documented 
here.  The  first  caller,  in  alphabetical  order,  is  listed  as 
well.  The  specification  in  which  any  nodule  is  docuaented  aay 
be  found  in  the  Module  Documentation  Index  (Document  Number 
CM  620100001).  See  section  3.10.6  for  a  list  of  the  nodules 
that  call  each  of  these  external  routines. 
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PARSE  NDML  COMMAND  External  Routines  List 


Module  Name 


ADDMOORR 

ADDCORR 

ADDTOCMT 

ADDTOLST 

IMITCMD 

VDMLPAS 

PR I RTF 

SPRIMTF 

STRLEM 

WRITERR 

YYIMPUT 

YTLEX 

YYOUTPUT 


First  U6er 


YY PARSE 
YYPARSE 
YYPARSE 
YYPARSE 
NDMLPAR 
MDMLPAR 
YYPARSE 
YY ERROR 
YYERROR 
YYERROR 
NDMLPAR 
YYPARSE 
NDMLPAR 
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3.10.4  Include  File  List 

The  following  is  a  list  of  all  include  files  called  in 
by  modules  being  documented  here.  Each  include  file  has  a 
unique  name  regardless  of  the  language  being  used.  The  purpose 
of  each  include  file  is  listed  as  well.  A  more  complete 
description  of  each  include  file  is  given  in  section  3.10.9. 

The  purpose  listed  is  the  one  that  is  in  the  source  code  of  the 
include  file. 

A  purpose  of  "•***  PURPOSE  HOT  FOUHD  BY  STRIPPER  ****" 
indicates  that  a  purpose  statement  was  not  written  into  the 
include  file  itself.  The  most  common  reason  for  this  is  that 
the  include  file  comes  from  system  libraries  that  were  not 
developed  by  the  project,  such  as  'C'  libraries  that  are 
provided  with  the  'C'  compiler. 

See  section  3.10.6  for  a  set  of  lists  which  show  all 
the  modules  which  call  in  each  of  these  include  files. 
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PARSE  NDML  COMMAND  Include  File  List 


File  Name  Purpose 


CMDS 

LISTID 

LISTS 

NDMLEXT 

NDML Y AC . INP" 

STDIO 

STDTYP 


COMMAND  NO.  FOR  EACH  NDDL/NDML  COMMAND 
PROVIDES  LIST  OF  PARSED  OBJECTS 
PROVIDES  THE  DIMENSIONS  OF  THE  NDDL  LISTS 
LEX  GENERATED  INCLUDE  FILE 
**»»  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 
PURPOSE  NOT  FOUND  BY  STRIPPER  **** 
STANDARD  TYPE  DEFINITIONS 
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3.10.5  Where  Include  File  Used  List 

The  following  lists  each  include  file  from  3.10.4  and 
all  the  modules  documented  in  this  specification  which  include 
them.  The  purpose  of  each  module  is  listed  as  well. 
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PARSE  MDML  COMMAND  Where- include-f i le-used  List 


Include 

File 

Module 

Name 

Module 

Purpose 

CMDS 

YYERROR 

****  PURPOSE 

NOT 

FOUND 

BY 

STRIPPER 

*  •  *  * 

YYPARSE 

****  PURPOSE 

HOT 

FOUND 

BY 

STRIPPER 

*  •  *  * 

YYWRAP 

****  PURPOSE 

NOT 

FOUND 

BY 

STRIPPER 

*  »  *  * 

LISTID 


YYERROR 

YYPARSE 

YYWRAP 


LISTS 


YYERROR 

YYPARSE 

YYWRAP 


NDMLEXY 


YYERROR 

YYPARSE 

YYWRAP 


MDMLYAC.INP" 

YYERROR 

YYPARSE 

YYWRAP 


***•  PURPOSE  MOT  FOUND  BY  STRIPPER  *•** 
****  PURPOSE  NOT  FOUND  BY  STRIPPER  **•* 
****  PURPOSE  NOT  FOUND  BY  STRIPPER  •**» 


****  PURPOSE  NOT  FOUND  BY  STRIPPER  •••* 
****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 
****  PURPOSE  NOT  FOUND  BY  STRIPPER  •*** 


PURPOSE  NOT  FOUND  BY  STRIPPER  *•*» 
••••  PURPOSE  NOT  FOUND  BY  STRIPPER  *•»* 
PURPOSE  NOT  FOUND  BY  STRIPPER 


****  PURPOSE  NOT  FOUND  BY  STRIPPER 
****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 
****  PURPOSE  NOT  FOUND  BY  STRIPPER  **•* 


a 
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V.  « 
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PARSE  NDML  COMMAND  Where-include-f i le-used  List 


Include  Module  Module 

File  Name  Purpose 


STDIO 

NDMLPAR  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 
YYERROR  *  *  *  *  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 
YYPARSE  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 
YYWRAP  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 


STDTYP 

NDMLPAR  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 
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3.10.6  Where  External  Routine  Used  List 

The  following  lists  each  external  function  or  routine 
listed  in  3.10.3  and  all  the  documented  modules  which  call  it. 
The  purpose  of  each  module  is  listed  as  well. 
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PARSE  MDML  COMMAND  Where-external-rout ine-used  List 


System 

Module 

Module 

Name 

Module 

Purpose 

ADDNCORR 

YYPARSE 

*  •  *  * 

PURPOSE 

NOT 

FOUND 

BY 

STRIPPER 

»  »  *  9 

ADDCORR 

YYPARSE 

*  *  *  * 

PURPOSE 

NOT 

FOUND 

BY 

STRIPPER 

*  *  *  * 

ADD  TO  CUT 

YYPARSE 

*  *  *  * 

PURPOSE 

NOT 

FOUND 

BY 

STRIPPER 

*  *  *  * 

ADD  TO  LST 

YYPARSE 

•  *  *  * 

PURPOSE 

NOT 

FOUND 

BY 

STRIPPER 

*  *  *  * 

INITCMD 

NDMLPAR 

♦  *  *  * 

PURPOSE 

NOT 

FOUND 

BY 

STRIPPER 

*  *  *  * 

NDMLPAS 

NDMLPAR 

*  *  *  * 

PURPOSE 

NOT 

FOUND 

BY 

STRIPPER 

•  •  *  * 

PRINTF 

YYPARSE 

*  *  *  * 

PURPOSE 

NOT 

FOUND 

BY 

STRIPPER 

•  *  *  * 

SPRINTF 

YYERROR 

*  •  •  • 

PURPOSE 

NOT 

FOUND 

BY 

STRIPPER 

t  *  *  • 
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PARSE  MDML  COMMAND  Where-external -routine-used  List 


System 

Module 

Module 

Module 

Marne 

Purpose 

STRLEN 

YY ERROR 

PURPOSE 

HOT 

FOUND 

BY 

STRIPPER 

«  *  •  * 

YYPARSE 

PURPOSE 

MOT 

FOUND 

BY 

STRIPPER 

•  *  •  * 

WRITER* 

YYERROR 

*  *  «  « 

PURPOSE 

HOT 

FOUND 

BY 

STRIPPER 

*  *  •  • 

YTIMPUT 

HDMLPAR 

•  *  •  * 

PURPOSE 

HOT 

FOUND 

BY 

STRIPPER 

*  *  *  * 

TYLEX 

YYPARSE 

*  *  •  * 

PURPOSE 

HOT 

FOUND 

BY 

STRIPPER 

*  •  •  * 

TYOOTPUT 

MDMLPAR 

•  *  *  * 

PURPOSE 

MOT 

FOUND 

BY 

STRIPPER 

*  »  *  * 
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3.10.7  Main  Program  Parts  List 

The  following  lists  each  Main  Program  listed  in  3.10.1 
and  all  the  modules  which  are  called  either  by  that  module 
itself  or  by  any  of  the  documented  modules  which  it  calls.  It 
is  possible  for  a  non-main  module  to  be  listed  more  that  once 
if  it  is  called  by  multiple  modules.  The  called  modules,  in 
this  case  known  as  program  parts,  are  marked  as  to  whether 
they  are  documented  here.  If  so,  the  phrase  "well-defined 
module”  appears  by  the  module  name,  if  not  it  is  an  "external 
"routine".  The  Purpose  of  the  Main  Program  module  is  listed 
as  well . 


i 

i 

t 
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Main  Pgm 
Name 

NDMLPAR 


PARSE  NIHIL  COMMAND  Main  Program  Parts  List 

Module  Module 

Name  Type 


Purpose — >*»**  PURPOSE  NOT  FOUND  BY 
STRIPPER  **** 

INITCMD  External  routine 
NDMLPAS  External  routine 
YY INPUT  External  routine 
YYOUTPUT  External  routine 
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PARSE  MDML  COMMAND  Main  Program  Parts  List 


Main  Pgn 

Module 

Module 

Name 

Name 

Type 

YY PARSE 

Purpose —  > 

****  PURPOSE  NOT  FOUND  BY 

STRIPPER  **** 

ADDNCORR 

External 

routine 

ADD  CORR 

External 

routine 

ADD  TO  CNT 

External 

routine 

ADD  TO  LST 

External 

routine 

PRINTF 

External 

routine 

SPRINTF 

External 

routine 

STRLEN 

External 

routine 

WRITERR 

External 

routine 

YYERROR 

Well-defined  module 

YYLEX 

External 

routine 
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3.10.8  Module  Documentation 

The  following  documentation  describes  information 
which  is  specific  to  each  individual  module  being  documented 
in  this  specification  as  listed  in  section  3.10.2.  It 
provides  a  compact  way  of  getting  information  that  would  be 
otherwise  buried  within  each  module's  source  code. 


The  specific  items  in  this  module  documentation  have  the 
following  meanings: 


NAME: 


Name  of  program  Module. 


PURPOSE : 


Purpose  of  Module  as  detailed  in  the 
source  code. 


LANGUAGE:  Programming  language  source  code  is 

written  in. 

The  choices  are: 

VAX-11  FORTRAN 
C  Cl/S-1  Workbench  C) 

VAX-11  COBOL 


MODULE  TYPE: 


Whether  a  Program,  Subroutine,  or 
Function. 


SOURCE  FILE: 

SOURCE  FILE  TYPE: 


HOST: 


SUBSYSTEM : 

SUBDIRECTORY : 


Name  of  Source  File  from  file 
specification. 

Source  File  Extension  from  file 
specification. 

Whether  this  is  a  host -dependent 
routine  (VAX  or  IBM)  or  blank  if 
host -independent . 

IISS  sub-system  this  file  resides 
in . 

Sub-directory  of  that  subsystem  in 
which  this  file  resides. 


DOCUMENTATION  GROUP:  Name  of  documentation  group  of  which 

this  source  file  is  a  member. 


DESCRIPTION: 


A  description  of  the  module  as 
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ARGUMENTS : 


INCLUDE  FILES: 


ROUTINES  CALLED: 


CALLED  DIRECTLY  BY: 

USED  IN  MAIN  PROGRAM(S) : 


otained  from  the  souree  code. 

The  arguments  with  which  this 
routine  is  called  if  it  is  a 
Subroutine  or  a  Function. 

A  list  of  all  the  files  that  are 
included  into  this  nodule  as  well  as 
their  purposes. 

Subroutines  or  Functions,  either 
documented  or  external,  called  by 
this  nodule,  if  any. 

The  documented  routines  which  call 
this  nodule,  if  any . 

The  documented  Main  Programs  which 
contain  this  module  in  their  parts 
list  according  to  the  list  in 
section  3.10.7. 


The  Module  Documentation  is  arranged  alphabetically  according  to 
Module  Name. 
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PARSE  NDML  COMMAND  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE: 

MODULE  TYPE: 
FUNCTION  TYPE: 
SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 


NDMLPAR 

****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 
C 

FUNCTION 
I  NT  () 

NDMLPAR 

.C 

CDM 

PS41213 


DESCRIPTION: 


ARGUMENTS: 


I  NT  * 
I  NT  • 


COM  NO  - 
STATUS  - 


INCLUDE  FILES: 


STANDARD  TYPE  DEFINITIONS 

••••  PURPOSE  NOT  FOUND  BY  STRIPPER  •*•• 


STDTYP 

STDIO 


ROUTINES  CALLED: 


INITCMD 
NDMLPAS 
YY INPUT 
YYOUTPUT 
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PARSE  NDML  COMMAND  Module  Documentation 


NAME: 

PURPOSE: 

LANGUAGE : 

MODULE  TYPE: 
FUNCTION  TYPE: 
SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 

DESCRIPTION: 


ARGUMENTS : 


S  -  CHAR  * 


INCLUDE  FILES: 


NDMLYAC . IN 
STD  10 
CMDS 
LISTS 

LISTID 

NDKLEXY 


ROUTINES  CALLED: 


SPRINTF 

STRLEN 

WRITERR 


CALLED  DIRECTLY  BY: 


YYPARSE  -  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 
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1 


-  PURPOSE  NOT  FOUND  BY  STRIPPER  »*** 

-  *  *  *  *  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

-  COMMAND  NO.  FOR  EACH  NDDL/NDML  COMMAND 

-  PROVIDES  THE  DIMENSIONS  OF  THE  NDDL 
LISTS 

-  PROVIDES  LIST  OF  PARSED  OBJECTS 

-  LEX  GENERATED  INCLUDE  FILE 


YY ERROR 

****  PURPOSE  NOT  FOUND  BY  STRIPPER  ***• 
C 

FUNCTION 
I  NT  () 

NDMLYTB 

.C 

CDM 

PS41213 
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USED  IN  MAIM  PROGRAM(S): 

YYPARSE  -  ****  PURPOSE  MOT  FOUND  BY  STRIPPER  •*** 
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PARSE  NDML  COMMAND  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 
FUNCTION  TYPE: 
SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 


YYPARSE 

****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 
C 

FUNCTION 
I  NT  () 

NDMLYTB 

.C 

CDM 

PS41213 


DESCRIPTION: 


INCLUDE  FILES: 


NDMLYAC. IN 
STDIO 
CMDS 
LISTS 

LISTID 

NDMLEXY 


****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 
****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 
COMMAND  NO.  FOR  EACH  NDDL/NDML  COMMAND 
PROVIDES  THE  DIMENSIONS  OF  THE  NDDL 
LISTS 

PROVIDES  LIST  OF  PARSED  OBJECTS 
LEX  GENERATED  INCLUDE  FILE 


ROUTINES  CALLED: 


PRINTF 

ADDTOLST 

ADDCORR 

STRLEN 

ADDNCORR 

ADD_TO_CNT 

YYERROR  -  ****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 

YYLEX 
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PARSE  NDML  COMMAND  Module  Documentation 


NAME: 

PURPOSE: 

LANGUAGE: 

MODULE  TYPE: 
FUNCTION  TYPE: 
SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 


YYWRAP 

****  PURPOSE  NOT  FOUND  BY  STRIPPER  **** 
C 

FUNCTION 
I  NT  () 

NDMLYTB 

-C 

CDM 

PS41213 


DESCRIPTION: 


INCLUDE  FILES: 


NDMLYAC.IH  - 
STDIO 
CMOS 
LISTS 

LISTID 

NDMLEXY 


**•*  PURPOSE  NOT  FOUND  BY  STRIPPER  *••• 

-  »***  PURPOSE  NOT  FOUND  BY  STRIPPER  *»** 

-  COMMAND  NO.  FOR  EACH  NDDL/NDML  COMMAND 

-  PROVIDES  THE  DIMENSIONS  OF  THE  NDDL 
LISTS 

-  PROVIDES  LIST  OF  PARSED  OBJECTS 

-  LEX  GENERATED  INCLUDE  FILE 
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3.10.9  Include  File  Descriptions 


The  following  list  contains  a  purpose  and  description  of 
each  include  file  listed  in  3.10.4  as  specified  in  the  source 
code.  The  language  it  is  written  in  is  also  given. 


! 


t. 


r 


i 


* 

y 

* 
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PARSE  NDML  COMMAND  Include  File  Description 


FILE  NAME: 
PURPOSE : 
LANGUAGE: 


CMDS 

COMMAND  NO.  FOR  EACH  NDDL/NDML  COMMAND 
C 


DESCRIPTION: 


DESCRIPTION 

CONTAINS  THE  UNIQUE  COMMAND  MUBER  FOR  EACH  NDDL  AND  NDML 
COMMAND.  THIS  NUMBER  IS  USED  IN  PROCESSING  TO  DETERMINE  THE 
APPROPRIATE  PROCESSOR  TO  EXECUTE. 
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PARSE  NDML  COMMAND  Include  File  Description 


FILE  NAME: 

PURPOSE: 

LANGUAGE: 


LISTID 

PROVIDES  LIST  OF  PARSED  OBJECTS 
C 


DESCRIPTION: 


DESCRIPTION 
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PARSE  NDML  COMMAND  Include  File  Description 


FILE  NAME:  LISTS 

PURPOSE:  PROVIDES  THE  DIMENSIONS  OF  THE  NDDL  LISTS 

LANGUAGE:  C 

DESCRIPTION: 


DESCRIPTION 
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PARSE  NDML  COMMAND  Include  File  Description 


FILE  NAME: 

PURPOSE: 

LANGUAGE: 


STDTYP 

STANDARD  TYPE  DEFINITIONS 
C 


DESCRIPTION: 


DESCRIPTION 

THIS  FILE  ENSURES  THAT  THE  FOLLOWING  STANDARD  TYPES  ARE 
AVAILABLE : 

FLOAT  -  SINGLE  PRECISION  FLOAT 

DOUBLE  -  DOUBLE  PRECISION  FLOAT 


LONG  -  32  BIT  (OR  LARGER)  SIGNED  INTEGER 

LBITS  -  32  BITS  (OR  MORE)  FOR  BIT  MANIPULATION 


INT 

-  NATURAL 

UNSIGNED 

-  NATURAL 

BOOL 

-  NATURAL 

ONLY) 

SIZE  SIGNED  INTEGER 

SIZE  UNSIGNED  INTEGER 

SIZE  LOGICAL  (ZERO  /  NON-ZERO 


SHORT 

USHORT 

BITS 


16  BIT  (OR  LARGER)  SIGNED  INTEGER 
16  BIT  (OR  LARGER)  UNSIGNED  INTEGER 
16  BITS  (OR  MORE)  FOR  BIT  MANIPULATION 


CHAR 

TINY 

UTINY 

TBITS 

TBOOL 

ONLY) 


-  SINGLE  MACHINE  CHARACTER  (REAL  CHARACTERS 
ALWAYS  POSITIVE) 

-  8  BIT  (OR  LARGER)  SIGNED  INTEGER 

-  8  BIT  (OR  LARGER)  UNSIGNED  INTEGER 

-  8  BITS  (OR  MORE)  FOR  BIT  MANIPULATION 

-  8  BIT  (OR  LARGER)  LOGICAL  (ZERO  /  NON-ZERO 


METACHAR  -  16  BIT  (OR  LARGER)  AUGMENTED  CHARACTER 

(SIGNED) 


VOID 


FUNCTION  THAT  RETURNS  NO  VALUE 


FORTRAN  -  STORAGE  CLASS  FOR  FOREIGN  (NON-C)  ROUTINES 

OR  C  ROUTINES 

WHICH  ARE  CALLABLE  FROM  FOREIGN  ROUTINES 


SINCE  NOT  ALL  COMPILERS  SUPPORT  USHORT. 


3-33 


PS  620141213 
1  November  1985 


TINY.  AND  UTINY, 

THE  FUNCTIONS 

USHORTC).  TINY(),  AND  UTINY ( )  SHOULD  BE  USED 
WHENEVER  REFERENCING  THEM. 

IN  ADDITION.  THE  FOLLOWING  UTILITY  MACROS 
ARE  DEFINED:  LURSHIFT(N,  B) 

-  UNSIGNED  LONG  RIGHT  SHIFT  MAX(A,  B) 

-  MAXIMUM  OF  A  AND  B  MIN(A.  B)  -  MINIMUM  OF 
A  AND  B 
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PARSE  NDML  COMMAND  Include  File  Description 


ABS(A)  -  ABSOLUTE  VALUE  OF  A 

STRASNCA.  B)  -  TRANSPORTABLE  A  -  B  FOR  STRUCTURES 

NULL  -  NULL  POINTER  VALUE  CO) 

TRUE  -  1 

FALSE  -  0 

SUCCESS  -  EXITC SUCCESS)  INDICATES  SUCCESSFUL 
COMPLETION 

FAILURE  -  EXITC FAILURE)  INDICATES  ERRORS 

THE  FOLLOWING  SYMBOLS  SHOULD  BE  DEFINED  BASED  ON  THE 
COMPILER  BEING  USED: 

USHORT  -  COMPILER  SUPPORTS  UNSIGNED  SHORT 

TINY  -  COMPILER  TREATS  CHAR  AS  SIGNED 

UTINY  -  CHAR  IS  SIGNED  AND  COMPILER  SUPPORTS 
UNSIGNED  CHAR 

VOID  -  COMPILER  SUPPORTS  VOID 

FORTRAN  -  COMPILER  SUPPORTS  FORTRAN 

STRASN  -  DEFINE  APPROPRIATE  MACRO 

SUCCESS  -  DEFINE  APPROPRIATE  VALUE  IF  NOT  0 

FAILURE  -  DEFINE  APPROPRIATE  VALUE  IF  NOT  1 
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3.10.10  Hierarchy  Chart 

The  following  hierarchy  charts  show  the  relationships 
between  all  of  the  modules  mentioned  in  the  above  documentation. 
A  module  may  call  a  subroutine  several  times  within  its  code, 
but  the  call  will  only  be  shown  once  as  a  single  relationship  on 
this  hierarchy  chart.  All  modules  shown  at  the  top  of  the  first 
page  are  considered  Main  Programs  as  described  in  section  3.10.1 
above. 

There  is  an  internal  paging  scheme  as  marked  by  the  numbers 
in  the  upper  right  corner  of  each  page.  An  index  after  the  last 
page  of  the  chart  shows  where  a  routine  and  its  calls  are  first 
defined.  If  a  routine  has  no  page  reference,  it  either  makes  no 
calls  or  is  an  external  routine.  A  continuation  box  on  the  end 
of  a  tree  limb  shows  where  that  the  tree  continues  on  the  page 
numbered  mentioned.  A  number  in  a  box  with  a  routine  name 
points  to  the  page  where  the  routine  is  further  defined  within 
the  hierarchy  tree.  If  there  is  no  number  in  a  box.  the  routine 
either  makes  no  calls  or  is  an  external  routine. 
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SECTIOW  4 

QUALITY  ASSURANCE  PROVISIONS 


4.1  Introduction  and  Definitions 


"Testing"  is  a  systematic  process  that  may  be  preplanned 
and  explicitly  stated.  Test  techniques  and  procedures  may  be 
defined  in  advance,  and  a  sequence  of  test  steps  may  be 
specified.  "Debugging"  is  the  process  of  isolation  and 
correction  of  the  cause  of  an  error. 

"Antibugging"  is  defined  as  the  philosophy  of  writing 
programs  in  such  a  way  as  to  make  bugs  less  likely  to  occur  and 
when  they  do  occur,  to  make  them  more  noticeable  to  the 
programmer  and  the  user.  In  other  words,  as  much  error  checking 
as  is  practical  and  possible  in  each  routine  should  be 
performed . 

4.2  Computer  Programming  Test  and  Evaluation 

The  quality  assurance  provisions  for  test  consists  of  the 
normal  testing  techniques  that  are  accomplished  during  the 
construction  process.  They  consist  of  design  and  code 
walk-throughs,  unit  testing,  and  integration  testing.  These 
tests  are  performed  by  the  design  team.  Structured  design, 
design  walk-through  and  the  incorporation  of  "antibugging" 
facilitate  this  testing  by  exposing  and  addressing  problem  areas 
before  they  become  coded  "bugs." 
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